Clarify GtkSettings documentation
authorMatthias Clasen <mclasen@redhat.com>
Mon, 20 Oct 2014 00:47:05 +0000 (20:47 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Mon, 20 Oct 2014 00:47:05 +0000 (20:47 -0400)
Just recommend g_object_set to override settings. The
gtk_settings_set_..._property functions don't really add
any value.

gtk/gtksettings.c

index 2cb6a8151e7d899ab38673f33492e78c8a825fe9..ab720d801db085ded664bfcba6c74db6c266ceac 100644 (file)
  * for settings by installing a `settings.ini` file
  * next to their `gtk.css` file.
  *
- * Applications can override system-wide settings with
- * gtk_settings_set_string_property(), gtk_settings_set_long_property(),
- * etc. This should be restricted to special cases though; GtkSettings are
- * not meant as an application configuration facility. When doing so, you
- * need to be aware that settings that are specific to individual widgets
- * may not be available before the widget type has been realized at least
- * once. The following example demonstrates a way to do this:
+ * Applications can override system-wide settings by setting the property
+ * of the GtkSettings object with g_object_set(). This should be restricted
+ * to special cases though; GtkSettings are not meant as an application
+ * configuration facility. When doing so, you need to be aware that settings
+ * that are specific to individual widgets may not be available before the
+ * widget type has been realized at least once. The following example
+ * demonstrates a way to do this:
  * |[<!-- language="C" -->
  *   gtk_init (&argc, &argv);
  *